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PREFACE 



This manual describes the Lingage Editor included in the development package 
available as an option with the OASIS Operating System. 

This manual, named LINKREF, like all OASIS documentation manuals, has the manual 
name and revision number in the lower, inside corner of each page of the body of 
the manual. In most chapters of the manual the last primary subject being 
discussed on a page will be identified in the lower outside corner of the page. 



Related Documentation 

The following publications provide additional information useful in the use of the 
this program: 

OASIS System Reference Manual 

OASIS EXEC Language Reference Manual 

OASIS Text Editor Reference Manual 

OASIS MACRO Assembler Language Reference Manual 

OASIS Dynamic Debugger Reference Manual 
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CHAPTER 1 
INTRODUCTION 

The OASIS Linkage Editor is a command program that is used to "link" together the 
output of an assembly or compilation process into an executable load module. This 
is a necessary step that follows the source program assembly or compilation of any 
problem program (except those programs written for the EXEC language processor, the 
OASIS BASIC compiler /interpreter, or the OASIS COBOL compilor). 

Every program is designed to fulfill a particular purpose. To achive that purpose, 
the program can generally be divided into logical units that perform specific 
functions. A logical unit of coding that performs a function, or several related 
functions, is a module. Ordinarily, separate functions should be programmed into 
separate modules, a process called modular programming. 

Each module is separately assembled or compiled by one of the language translators. 
The input to a language translator is a source module; the output from a language 
translator is an object module. Before an object module can be executed, it must 
be processed by the Linkage Editor. The output of the Linkage Editor is a load 
module. 

Source Program 

I 

I 

\l/ 

Language Translator > Program Lising 

I 
I 

\l/ 
Object Program 

I 
I 
\l/ 
Linkage Editor > Map Listing 

I 
I 

\l/ 
Load Program 

Any module is composed of one or more program address blocks (PABS). A PAB is a 
unit of coding (instructions and data) that is, in itself, an entity. A PAB is the 
smallest separately relocatable unit of a program. 

Each module in the input to the Linkage Editor may contain symbolic references to 
PABS in other modules; such references are called external references. The symbol 
referred to by an external reference must be either the name of a PAB or the name 
of an entry point in a PAB. PAB names and entry names are called external names. 
By matching an external reference with an external name, the Linkage Editor 
resolves references between modules. 

The following chapters discuss the syntax of the LINK command, the use and 
requirements of the input files to the Linkage Editor, and the output of the 
Linkage Editor. 
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CHAPTER 2 

LINK COMMAND 

The OASIS Linkage Editor is invoked by executing the LINK command. The syntax of 
the command is : 



LINK [<fn> [<ft> [<fd>]]] [(<option>.-.[)]] 



Where: 



<fn> Indicates the file name of the object file to be linked or the file name 
of the specifications file (see FILE option). 

<ft> Indicates the file type of the object file to be linked or the file type 
of the specifications file (see FILE option). A default file type of 
OBJECT will be used when option FILE is not specified and a default file 
type of LINK will be used when option FILE is specified. 

<fd> Indicates the file disk of the object file to be linked or the file disk 
of the specifications file (see FILE option). When no <fd> is specified 
the default file search sequence will be used (see OASIS System Reference 
Manual ) . 

LINK Options 

FILE Indicates that the file description specified is the file description of 
the file containing the LINK control parameters. 

SYSTEM Indicates that the output is a system file. For example: LINK CLASS2 
(SYSTEM outputs the file SYSTEM. CLASS2:S . 

USR Indicates the the output is a BASICUSR file. For example: LINK UPPER (USR 
outputs the file UPPER. BASICUSR. 

DRIVE=x Indicates the drive that the output file is to reside on. When this 
option is not specified the output file will be on the same drive as the 
input file. 

BOOT Indicates that the output is a bootstrap loader. When this option is 
specified the first 256 bytes of the output of the linkage is written to 
sector of the output drive. 

TYPE Indicates that the linkage parameters and map are to be displayed on the 
console. This is a default option. 

NOTYPE Indicates that the linkage parameters and map are not to be displayed on 
the console. 

PRINTER [n] Indicates that the linkage parameters and map are to be output to the 
printer specified. If n is not specified then PRINTER1 is used. 

NOPRINT Indicates that the linkage parameters and map are not to be output to the 
printer. This is a default option. 

DISK[=x] Indicates the drive that the output listing file is to be written to. 
When this option is specified the linkage parameters and map are written 
to a disk file with a file name equal to the <fn>, a file type of LINKMAP 
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and the drive specified by this option. 

This option is not implemented as of this release. 



XREF 
NOXREF 

MAP 

NOMAP 
WORK=x 



This option suppresses the cross reference table generation. This is a 
default option. 

Indicates that the linkage map is to be generated and output to the 
listing device. This is a defalut option. 

Indicates that the linkage map is not to be generated. 



Indicates the drive to be used for the linkage work files 
option is not specified the system disk will be used. 



When this 



When the LINK command is invoked with no file description specified the program 
will expect the specifications file to be entered from the console. In this mode 
the LINK prompt character (#) will be displayed when the LINK command is waiting 
for a command. 
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CHAPTER 3 

LINK INPUT FILES 

3-1 Specification File 

The link specification file is the input file that controls that basic operations 

of the linkage process. This file may be a console file or a disk file. It is not 

necessary to use the specification file, in fact, the normal simple linkages don't 
use this file. 

The specification file is normally used when two or more object modules are being 
linked together or when some parameters of the resulting load module need to be 
modified from the object code. 

To use the console as a specification file do not specify a file description when 
invoking the Linkage Editor. For example: >LINK (PRINT. 

To use a disk file as a specification file you must use the option FILE when 
invoking the Linkage Editor and there must be a file description specified. For 
example: >LINK TEST (FILE PRINT SYSTEM NOMAP. 

In the following subsections the term <expression> refers to an arithmetic 
expression involving constants, previously defined symbols, and the operators +, -, 
*, and /. For example: 

LABEL+23 
LOC 1+4*1 OH 
1000H 

An expression is evaluated in a left to right manner with no operator precedence. 
Numeric constants may be in decimal or hexadecimal (trailing H). String constants 
are specified with single quote characters surrounding them. 

3.1.1 DEFINE Command 

The DEFINE command allows you to assign a value to a symbol. The format of the 
command is : 

DEFI NE <33nnbol> ai <expresslon> 

Where: 

<symbol> Specifies the symbol that is to be assigned a value. This symbol must 
have already been defined by one of the included object modules. 

<expression> Specifies the value that is to be assigned to <symbol>. 

The DEFINE command is normally used to resolve an unresolved reference. 

3*1.2 END Comiand 

The END command marks the end of the input specification file records and instructs 
the Linkage Editor to output the load module and the load map. The format of the 
command is : 
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When the END command is encountered the Linkage Editor attempts to resolve any 
unresolved references by searching all attached disks for object files with a file 
name the same as an unresolved reference. When a qualifying object file is found 
an INCLUDE is performed on that file. This process is repeated until the end of 
the table of unresolved references is reached. (Note: including a file in this 
manner may cause more unresolved references to be formed.) 

When all references have been resolved that can be resolved in this manner and 
there still remains one or more unresolved references an implied LIST command is 
performed and the Linkage Editor returns to the console for further commands. 

If there are no more unresolved references the load module is created on the 
specified or default disk, the load map is output to the list device and the 
Linkage Editor is exited. 

3.1.3 ENTRY Command 

The ENTRY command allows you to specify the execution entry point of the load 
module. The format of the command is: 



ENTR Y <expression> 



Where: 



<expression> Indicates the address of the entry point. 

An ENTRY command has precedence over any end-of-file instructions that might 
specify an execution entry point. 

3.1.4 INCLUDE Command 

The INCLUDE command is the primary command of the input specification file. The 
INCLUDE command instructs the Linkage Editor to locate, analyze and assimilate an 
object file into the load module. The format of the command is: 



INCL UDE <module name>[,<module name>] 



Where: 



<module#name> Indicates the name of the object file to be included at this time. 
The file type of the object file must be OBJECT. More than one module 
name may be specified with one INCLUDE command by separating the module 
names with commas. 

When the Linkage Editor receives an INCLUDE command it searches the attached disks 
for the module and includes the text and instructions of that module into the load 
module being built. 

3.1.5 IGNORE Command 

The IGNORE command allows you to create a load module that contains unresolved 
references by instrucing the Linkage Editor to ignore certain symbols. The format 
of the command is: 

IGNO RE <symbol>[,<symbol>]... 
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Where: 

<symbol> Indicates the symbol that is to be ignored by the Linkage Editor. More 
than one symbol may be specified with one IGNORE command by separating the 
symbols with commas. 

When a symbol is ignored by the Linkage Editor in this manner it is important to 
note that the reference to it is not actually taken out of the text of the load 
module — it merely references relative address zero. You should not ignore a symbol 
whose reference code is actually executed — the results will be undefined. 

3.1.6 LIST Command 

The LIST command allows you to see all of the currently unresolved references. The 
format of the command is: 

LIST 

When the LIST command is encountered the Linkage Editor displays all currently 
unresolved references on the list device. 

3.1.7 NAME Command 

The NAME command allows you to specify a program name for the load module that is 
different from the default. (The default name will be the name of the first 
included object module.) The format of the command is: 

NAME <fn>[.<ft>J[:<fd>] 

Where: 

<fn> Indicates the file or program name of the load module. 

<ft> Indicates the file type of the load module. When this parameter is not 
specified the default file type will be used. (The default file type is 
dependent upon options used in the LINK command.) 

<fd> Indicates the file disk of the load module. When this parameter is not 
specified the default file disk will be used. (The default file disk is 
dependent upon options used in the LINK command.) 

3.1.8 ORIGIN Command 

The ORIGIN command allows you to change a relocatable load module into an absolute 
load module. The format of the command is: 

ORIG IN <expression> 

Where: 

<expression> Specifies the address that the load module is to be loaded at« 

The ORIGIN command causes the relocation table to be used to change all relocatable 
references to absolute references and changes the load module into an absolute 
command module (the relocation table is not included in the load module). 

LINKREF - 7 - SPECIFICATION FILE 



LINKAGE EDITOR REFERENCE MANUAL 

3.1.9 OVERLAY Command 

The OVERLAY command is not implemented in this version of LINK. 

3.1.10 QUIT Command 

The QUIT command allows you to abort the linkage process without creating a load 
module. The format of the command is: 

QUIT 

The QUIT command might be used when it is discovered that there are object modules 
required that have not been assembled yet or when the linkage is merely a test to 
determine unresolved references. 

3.1.11 REPLACE Command 

The REPLACE command allows you to change references from one, possibly undefined, 
symbol to another symbol. The format of the command is: 

REPL ACE <symboll>«=<symbol2> 

Where: 

<symboll> Indicates the symbol that is to be replaced. 

<symbol2> Indicates the symbol that is to replace <symboll>. 

The REPLACE command provides an easy means of linking an unfinished program. For 
example, the program might have calls to subroutines that are unwritten as yet. 
The REPLACE command could be used to change these references to a dummy subroutine 
that does exist without making a lot of changes to the source program just for test 
purposes. 

Please note that symbols, as used by the Linkage Editor, are symbols defined as 
entry points, not just labels used in the assembly process. 

3.1.12 SET Command 

The SET command allows you to change the values in the load module text. The 
format of the command is: 

SET <expression>=<data> [ , <data>] ... 

Where: 

<expression> Specifies the address, relative to the base address of the load module 
of the text to be changed. 

<data> Is a list, separated by commas, of values that the text is to be changed 
to. 

The SET command is normally used in, and is invaluable for, the modifications of 
parameters, defaults, etc, of a program without the modification of the source 
program. 
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3-1-13 Comments 

Comments may be placed in the specifications file by using the semicolon (;) 

character. The Linkage Editor treats all characters in a record following the 

semicolon as a comment and will merely include them in any listing file that it may 
create. 

3.2 Object File 

An OASIS object file is the primary output file from the MACRO assembler and the 
primary input file to the Linkage Editor. An object file is a binary stream, 
sequential format file of control and text records. Each record in an object file 
consists of a header section and a text section. The header section for each 
record contains three values: 

<record lengthXrecord typeXPAB number> 

Where: 

<record length> Specifies the number of bytes in the record, including the record 
length byte. 

<record type> Specifies the type of record with one of the following codes: 

01 PAB definition record (P) 

03 Text record (T) 

05 Relocation record (R) 
07 Entry definition record (E) 
09 External reference record (X) 
0B PAB to PAB reference record (F) 
OF End of file record (Z) 

<PAB number > Indicates which PAB the data following refers to. 

Following the header section of a record is the text section. This text section 
varies in structure from one record type to another. The following sub-sections 
describe the format of each record type. The letter in parentheses is the letter 
displayed by the OASIS LIST command for that record type. 

3.2.1 PAB Definition Record (P) 

The PAB definition record specifies the PAB name, type, base address, and length. 
The PAB number and length are relative to the current object file only. 

<header><pab lengthXpab nameXpab typeXbase address> 

PAB types are coded as a number: 

01 = absolute 

02 = relocatable 

04 = common relocatable 

3.2.2 Text Record (T) 

The text record is normally the most common type of record in an object file. It 
contains the assembled instructions and data constants as specified in the source 
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program. 

<header><start addr><data> [<data>] • • • 

3.2.3 Relocation Record (R) 

The relocation record specifies a list of addresses within a PAB that must have the 
load address of the PAB added to them to form accurate address references. 
Although relocation record(s) may appear anywhere in the object file before the end 
of file record it is normal for this type of record to immediately follow the text 
records affected (see examples). 

<header><addr> [<addr>] 

3.2.4 Entry Definition Record (E) 

The entry definition record specifies an address within a PAB that has been 
specified as an entry point with the ENTRY instruction in the source program. 
Along with the address the entry label is specified. 

<header><entry addrXentry name> 

When the Linkage Editor encounters an entry definition record it saves the entry 
point location and label and also searches its unresolved references table looking 
for any references that can be resolved by this definition. 

3.2.5 External Reference Record (X) 

The external reference record specifies an address within a PAB that is a reference 
to a label specified as an externally defined label with an EXTRN instruction in 
the source program. The address and label referenced is specified in this record. 

<header><ref from addrXref to name> 

The Linkage Editor tries to resolve this external reference by matching it with its 
currently defined entry point locations (defined with the entry definition record). 
If no match is found the external reference data is saved in the unresolved 
references table. 

3.2.6 PAB to PAB Reference Record (F) 

The PAB to PAB reference record is a special type of external reference, similar to 

the external reference record. The main difference is that the referenced label 

was resolved by the assembler because the label was defined in another PAB of the 
same assembly. 

<headerXref from addrXref to pab>[<ref from addrXref to pab>]--- 

The PAB to PAB reference record specifies a list of addresses within a PAB that are 
references to other PABs. 

The Linkage Editor uses the information in this record by adding the referenced 
PAB's base address to the referencing address and also adds the referencing address 
to the relocation table. 
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3-2-7 End of File Record (Z) 



This record indicates the logical end of file for the object program. Normally 
this record is only two bytes in length (count and record type). When the source 
program contained an END statement that specified a starting address this record 
will also note the starting address and its PAB number. In this latter case the 
record length will be five. 

<header>[<start pabXstart addr>] 

3.2.8 Object File Record Examples 

The following example object records are displayed as the LIST command displays 
them. This differs from the actual contents of the records in that the record type 
is displayed with the letter code instead of the numeric code and addresses are 
displayed in normalized mode instead of Z80 mode (low byte first). 



10 P 00 04A2 MAP 02 0000 



08 T 00 00D9 7E19FF 



05 R 01 000A 0012 003F 



0D E 00 0039 MAP 



0D X 00 0052 HELPMSG 



09 F 00 004F 02 0086 01 



05 Z 00 0039 



PAB definition, record length 16, relative PAB 
number 0, PAB length of 1186, PAB name is MAP, 
PAB type is relocatable, base address of 0. 
Text record, record length 8, relative PAB 
number 0, addresses starting at 00D9, text is 
7E 19 FF at locations 00D9, 00DA, and 00DB 
respectively. 

Relocation record, record length 5, relative 
PAB number 1, relative addresses 000A, 0012, 
and 003F in that PAB must have the load addr- 
ess added to them before execution. 
Entry definition record, record length 13, 
relative PAB number 0, address 0039 is the 
entry point named MAP (trailing spaces added). 
External reference record, record length 13, 
relative PAB 0, address 0052 references exter- 
nal label HELPMSG (trailing space added). 
PAB to PAB reference record, record length 9, 
relative PAB number 0, address 004F is a ref- 
erence to relative PAB number 2, address 0086 
is a reference to relative PAB number 1. 
End of file record, record length 5, execution 
address is 0039 in PAB 0. 
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CHAPTER 4 
LINK OUTPUT FILES 

The output of the Linkage Editor generally includes two files: the load module and 
the listing file. The load module may be one of two forms dependant upon whether 
the load module is absolute or relocatable. 

Load modules, when output, are always output to a disk file. The listing file, 

when output, may be output to a disk file, the console (default), or to one of the 

attached printer devices, dependant upon the options specified to the Linkage 
Editor. 

4*1 Absolute Load Module File 

An absolute load module output by the Linkage Editor is an exact image of the 
program to be executed. The directory entry for this type of a file specifies the 
load address and the load address is the execution address. An example of this 
type of a load module is the SYSTEM.NUCLEUS:S. 

4.2 Relocatable Load Module File 

A relocatable load module output by the Linkage Editor consists of two sections. 
The first section is an exact image of the program to be executed if it were loaded 
at address zero. The second section is the relocation table for the first section. 

This relocation table consists of variable length records with the first byte 
specifying the word count. Following the word count byte are two byte entries 
(words) that specify relative addresses of the load module that need to have the 
relocation constant added to them before program execution begins. The relocation 
constant is the load address of the program. This load address is not known untill 
the program is actually loaded into memory by the system. 

The directory entry of a relocatable load module contains a record count that 
includes the recount count of both sections. Records in the first section are 
always 256 bytes in length. 

Most OASIS commands are distributed as relocatable load module files. 

4.3 Map Listing File 

The map listing file may be output to a disk file, the console or one of the 
printer devices, dependant upon the options specified to the LINK command. The 
DISK option will cause the listing file to be output to disk; the PRINTER option 
will cause the listing file to be output to one of the printers; the TYPE option 
will cause the listing file to be output to the console (default); the NOTYPE 

option will cause the listing file to be suppressed. 

The map listing file consists of two sections. The first section is a listing of 
the input specifications file, including any comments. 

The second section is a nemory map of the load module created by the Linkage 
Editor. This map is a listing of the PABs used in the load module. Listed with 
each PAB is the memory region used by the PAB, the PAB type, and the entry points 
defined in the PAB in ascending address sequence. 

At the end of the memory map the relative entry address is listed along with the 
total length of the load module. 
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LINK EXAMPLES 



A.l Example One: Simple. Single PAB 

>MACRO CLASS 6 

SYSTEM. CLASS6 - Hazeltine 1400-1500 



Addr Obj-Code Line *** Source Statement *** 



04/28/80 15:09 Page 1 
CLASS6. ASSEMBLE: S0URCE$$ 



0000 

0000 C33600 



0003 

0003 FE20 
0005 3804 
0007 CF40 
0009 AF 
000A C9 



000B 

000B FE10 
000D CA9F00 



0010 215F00 

0013 87 

0014 5F 

0015 1600 

0017 19 

0018 5E 

0019 23 
001A 56 



001B 7A 
001C B3 
001D 37 
001E C8 



2 

3 

4 

5 

6 
10+ 
11+ 
12+ 

13+; test 
14+ 

15+TRANOUT 
16+ 
17+ 
18+ 
19+ 
20+ 
21+ 

22+; test 
23+ 

24+CTL : 
25+ 
26+ 
27+ 
28+ 
30+ 
31+ 

32+; point 
33+ 
34+ 
35+ 
36+ 
37+ 
38+ 
39+ 
40+ 
41+ 
42+ 

43+; test 
44+ 
45+ 
46+ 
47+ 
48+ 
49+ 



; Operates with 1420, 1500, 1510, 1520 
; Change leadin to ESC for 1410 and 1552 
MACLIB CLASS 



INIT 

JP TRANIN 
if control 



CP 
JR 
SC 
XOR 

RET 



20H 
C,CTL 
DEVOUT 
A 



; input vector 



is it control? 
brif is 

else, display as is 
clear cy 



if dca x,y 



CP 
JP 

IF 
END IF 



DLE ; 
Z,DCA ; 

.NOT..NUL. 



is it 10H 
j ump if is 



to proper entry 



LD 

ADD 

LD 

LD 

ADD 

LD 

INC 

LD 



HL, TAB 1-2 

A 

E,A 

D,0 

HL,DE 

E,(HL) 

HL 

D,(HL) 



; point to indirect table 
code times two 
move to de 
16 bits 

point to correct slot 
get address in de 



for not available 



LD 
OR 
SCF 
RET 



A,D 
E 



; is address = zero? 

; set cy just in case 
; return if is 
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50+; put out codes until byte = OFFH 
51+ 



001F 




52+WRITE: 








001F 


1A 


53+ 




LD 


A,(DE) 


; get byte 


0020 


13 


54+ 




INC 


DE 


; bump 


0021 


FE8C 


55+ 




CP 


8CH 


; ff delay code? 


0023 


2807 


56+ 




JR 


Z,WRFFDLY 


; brif is 


0025 


4F 


57+ 




LD 


C,A 


; move to reg c 


0026 


3C 


58+ 




INC 


A 


; test for OFFH 


0027 


C8 


59+ 




RET 


Z 


; return if is 


0028 


CF40 


60+ 




SC 


DEVOUT 


; else, write to console 


002A 


18F3 


61+ 




JR 


WRITE 


; loop 


002C 




62+WRFFDLY: 








002C 


FD7E07 


63+ 




LD 


A,(IY+7) , 


get delay rate 


002F 


B7 


64+ 




OR 


A 


; any ? 


0030 


28ED 


65+ 




JR 


Z, WRITE 


; no, ignore 


0032 


CF4C 


66+ 




SC 


DELAY 


; else, pause 


0034 


18E9 


67+ 
68+ 
69+ 




JR 


WRITE 


; continue 






70+; 


input 


char translate routine 






71+ 










0036 




72+TRANIN: 












73+ 




IF 


.NUL. 








74+ 




IF 


.NUL. 








79+ 




ENDIF 










80+ 




IF 


.NUL. 








85+ 




ENDIF 










86+ 




IF 


.NUL. 








91+ 




ENDIF 










92+ 




IF 


.NUL. 








97+ 




ENDIF 










98+ 




IF 


.NUL. 








103+ 




ENDIF 










104+ 




IF 


.NUL. 








109+ 




ENDIF 










110+ 




IF 


.NUL. 








115+ 




ENDIF 










116+ 




IF 


.NUL. 








121+ 




ENDIF 










124+ 




ENDIF 






0036 


B7 


125+ 




OR 


A 


; clear cy 


0037 


FDCB057E 


126+ 




BIT 


7,(IY+5) ; 


is this conin device? 


003B 


C8 


127+ 




RET 


Z 


; no, return 


003C 


FDCB0576 


128+ 




BIT 


6,(IY+5) , 


2nd char of esc sequence? 


0040 


2013 


129+ 




JR 


NZ,ESC2 


; brif is 


0042 


FDE5 


130+ 




PUSH 


IY 


', save iy 


0044 


CF30 


131+ 




SC 


GET SCR 


; point to scr 


0046 


FDBE40 


132+ 




CP 


(IY+64) 


; is this an esc char 


0049 


FDE1 


133+ 




POP 


IY 


; restore iy 


004B 


2802 


134+ 




JR 


Z,ESC1 


; brif is 


004D 


B7 


135+ 




OR 


A 


; turn off cy 


004E 


C9 


136+ 




RET 




; return 


004F 




137+ESC1: 








004F 


FDCB05F6 


138+ 




SET 


6,(IY+5) 


, turn on code 


0053 


37 


139+ 




SCF 




; set cy 
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0054 


C9 


140+ 


RET 




return 


0055 




141+ESC2: 








0055 


FDCB05B6 


142+ 


RES 


6,(IY+5) ; 


turn off sw 


0059 


CBAF 


143+ 


RES 


5, A ; 


fold the char 


005B 


CF4E 


144+ 


SC 


CONESC ; 


go translate 


005D 


B7 


145+ 


OR 


A ; 


test if any 


005E 


CO 


146+ 


RET 


NZ ; 


yes, return 


005F 


37 


147+ 


SCF 




turn on cy 


0060 


C9 


148+ 
149+ 
150+ 
200 


RET 




return 


009F 




201 
204+ 


DCA 


6 




009F 




205+DCA: 
282+; 












283+; Haze 


ltine 1500 








284+; 








009F 


0E7E 


285+ 


ID 


c,'~' ; 


lead 1 


00A1 


CF40 


286+ 


SC 


DEVOUT 




00A3 


0E11 


287+ 


LD 


C,DC1 ; 


lead 2 


00A5 


CF40 


288+ 


SC 


DEVOUT 




00A7 


7C 


289+ 


LD 


A,H ; 


col number 


00A8 


C660 


290+ 


ADD 


96 ; 


bias 


OOAA 


4F 


291+ 


LD 


C,A 




OOAB 


CF40 


292+ 


SC 


DEVOUT ; 


display 


00 AD 


7D 


293+ 


LD 


A,L ; 


line number 


OOAE 


C620 


294+ 


ADD 


32 ; 


bias 


OOBO 


4F 


295+ 


LD 


C,A 




00B1 


CF40 


296+ 


SC 


DEVOUT ; 


display 


00B3 


AF 


297+ 


XOR 


A ; 


clear cy 


00B4 


C9 


298+ 

299+ 
300+ 
400 


RET 






00B5 




401 


DEFINE 


H0ME,~,DC2 




00B8 




524 


DEFINE 


CLEAR, ~,FS 


,8CH 


OOBC 




654 


DEFINE 


EOS, ~, CAN, 


8CH 


OOCO 




784 


DEFINE 


E0L,~,SI,8CH 


00C4 




914 


DEFINE 


LEFT,BS 




00C6 




1030 


DEFINE 


RIGHT, DLE 




00C8 




1146 


DEFINE 


UP,~,FF 




OOCB 




1269 


DEFINE 


D0WN,~,VT 




OOCE 




1392 


DEFINE 


IL,~,SUB 




00D1 




1515 


DEFINE 


IC 




00D2 




1624 


DEFINE 


DL,~,DC3 




00D5 




1747 


DEFINE 


DC 




00D6 




1856 


DEFINE 


EU,~,GS 




00D9 




1979 


DEFINE 


PON,"*, EM 




OODC 




2102 


DEFINE 


P0FF,~,US 




OODF 




2225 


DEFINE 


FON 




OOEO 




2334 


DEFINE 


FOFF 




00E1 




2443 


DEFINE 


B0N,~,S0H 




00E4 




2566 


DEFINE 


B0FF,~,US 




00E7 




2689 


DEFINE 


ULON 




00E8 




2798 


DEFINE 


ULOFF 
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00E9 


2907 


DEFINE RVON 


OOEA 


3016 
3125 


DEFINE RVOFF 


OOEB 


3126 


END 



No assembly errors. 

>LIST CLASS 6. OBJECT: A (OBJECT 

10 P 00 OOEB CODE 02 0000 

07 T 00 0000 C336 

80 T 00 0002 00FE203804CF40AFC9FE10CA9F00215F00875F1600195E23567AB337C8 
1A13FE8C28074F3CC8CF4018F3FD7E07B728EDCF4C18E9B7FDCB057EC8 
FDCB05762013FDE5CF30FDBE40FDE12802B7C9FDCB05F637C9FDCB05B6 
C6AFCF4EB7C037C9000000000000000000000000000000000000000000 
00000000000000 

3D T 00 007D 0000000000000000000000000000000000000000000000000000000000 
00000000000E7ECF400E11CF407CC6604FCF407DC6204FCF40AFC9 
0061 B500 
00B5 7E12FF 

0077 B800 
00B8 7E1C8CFF 
008F BCOO 
OOBC 7E188CFF 
008D C000 
00C0 7E0F8CFF 
006F C400 
00C4 08FF 
006B C600 
00C6 10FF 
0093 C800 
00 00C8 7E0CFF 
0073 CBOO 
OOCB 7EOBFF 
0081 CEOO 
OOCE 7E1AFF 
0085 D100 
00D1 FF 
0083 D200 
00D2 7E13FF 
0087 D500 
00D5 FF 
0097 D600 
00D6 7E1DFF 
0067 D900 
00D9 7E19FF 
0069 DCOO 
OODC 7E1FFF 
0063 DFOO 
OODF FF 
0065 EOOO 
OOEO FF 
0099 E100 
00E1 7E01FF 
009B E400 
00E4 7E1FFF 
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07 T 


00 


08 T 


00 


07 T 


00 


09 T 


00 


07 T 


00 


09 T 


00 


07 T 


00 


09 T 


00 


07 T 


00 


07 T 


00 


07 T 


00 


07 T 


00 


07 T 


00 


08 T 


00 


07 T 


00 


08 T 


00 


07 T 


00 


08 T 


00 


07 T 


00 


06 T 


00 


07 T 


00 


08 T 


00 


07 T 


00 


06 T 


00 


07 T 


00 


08 T 


00 


07 T 


00 


08 T 


00 


07 T 


00 


08 T 


00 


07 T 


00 


06 T 


00 


07 T 


00 


06 T 


00 


07 T 


00 


08 T 


00 


07 T 


00 


08 T 


00 
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07 T 00 0075 E700 

06 T 00 00E7 FF 

07 T 00 008B E800 

06 T 00 00E8 FF 

07 T 00 007B E900 

06 T 00 00E9 FF 

07 T 00 00 7D EA00 
06 T 00 OOEA FF 

37 R 00 0001 OOOE 0011 0061 0077 008F 008E 006F 006B 0093 0073 0081 0085 
0083 0087 0097 0067 0069 0063 0065 0099 009B 0075 008B 007B 
007D 

02 Z 

>LINK CLASS 6 (SYSTEM 

LINK version 5.4B CLASS6 04/28/80 14:06 Page 1 

Memory map for SYSTEM.CLASS6:S 

PAB-narae Low High Length Type Entry Addr 

CODE 0000 OOEA OOEB REL 

Entry Address: 0000 

Total Length: OOEB (235 decimal) 
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>DUMP SYSTEM CLASS 6 S 

Sector 1764 (Track=68, Sector=9) 

0000: C33600FE 203804CF 40AFC9FE 10CA9F00 '.6.. 8..@ ' 

0010: 215F0087 5F160019 5E23567A B337C81A '!_.._.. .~//Vz. 7. . ' 
0020: 13FE8C28 074F3CC8 CF4018F3 FD7E07B7 '... (.0<. .@...~.. ' 

0030: 28EDCF4C 18E9B7FD CB057EC8 FDCB0576 '(..L ~....v' 

0040: 2013FDE5 CF30FDBE 40FDE128 02B7C9FD ' ... .0. .@. .(.... ' 

0050: CB05F637 C9FDCB05 B6CBAFCF 4EB7C037 '...7 N..7' 

0060: C9B500DF 00E000D9 00DC00C6 000000C4 ' ' 

0070: 000000CB 00E700B8 000000E9 00EA0000 ' ' 

0080: 00CE00D2 00D100D5 000000E8 00C000BC ' ' 

0090: 000000C8 000000D6 00E100E4 0000000E ' ' 

OOAO: 7ECF400E 11CF407C C6604FCF 407DC620 '~.@. . .@ | . % 0.@}. ' 
00B0: 4FCF40AF C97E12FF 7E1C8CFF 7E188CFF '0.@. .~. .~. . .~. . . ' 

OOCO: 7E0F8CFF 08FF10FF 7E0CFF7E 0BFF7E1A '~ ~..~.."*.' 

OODO: FFFF7E13 FFFF7E1D FF7E19FF 7E1FFFFF '. .~. . .~. .~. .""... ' 

OOEO: FF7E01FF 7E1FFFFF FFFFFFOO 00000000 '.~..~ ' 

OOFO: 00000000 00000000 00000000 00000000 ' ' 

Sector 1765 (Track=68, Sector=10) 

0100 

0110 

0120 

0130 

0140 

0150 

0160 

0170 

0180 

0190 

01A0 

01B0 

01C0 

01D0 

01E0 

01F0 



1A01000E 00110061 0077008F 008D006F ' a.w o' 

006B0093 00730081 00850083 00870097 '.k...s ' 

00670069 00630065 0099009B 0075008B '.g.i.c.e u..' 

007B007D 00000000 00000000 00000000 '.{.} ' 

00000000 00000000 00000000 00000000 ' ' 

00000000 00000000 00000000 00000000 ' ' 

00000000 00000000 00000000 00000000 ' ' 

00000000 00000000 00000000 00000000 ' ' 

00000000 00000000 00000000 00000000 ' ' 

00000000 00000000 00000000 00000000 ' ' 

00000000 00000000 00000000 00000000 ' ' 

00000000 00000000 00000000 00000000 ' ' 

00000000 00000000 00000000 00000000 ' ' 

00000000 00000000 00000000 00000000 ' ' 

00000000 00000000 00000000 00000000 ' ' 

00000000 00000000 00000000 00000000 ' ' 



- 18 - LINKREF 



APPENDIX A: LINK EXAMPLES 



A. 2 Example Two: Specification File 



This example is a listing of the specification file used to link the OASIS NUCLEUS 
command. Note the aboundant use of comments and the modularity of the object 
modules. This makes maintenance of the program easier and is the recommended 
practice for all programs other than the simple, single module code. 

The various DEFINES, IGNORES and SETs are used to customize various parameters to a 
specific configuration. 

The file is named NUCLEUS. LINK and is used by entering the command: 

>LINK NUCLEUS (FILE 

NAME SYSTEM. NUCLEUS: A 



INCLUDE 
INCLUDE 
INCLUDE 
INCLUDE 
INCLUDE 
INCLUDE 
INCLUDE 
INCLUDE 
INCLUDE 
INCLUDE 
INCLUDE 
INCLUDE 
INCLUDE 
INCLUDE 
INCLUDE 
INCLUDE 
INCLUDE 
INCLUDE 
INCLUDE 
INCLUDE 
INCLUDE 
INCLUDE 
INCLUDE 
INCLUDE 
INCLUDE 
INCLUDE 
INCLUDE 
INCLUDE 
INCLUDE 
INCLUDE 
INCLUDE 
INCLUDE 
INCLUDE 
INCLUDE 
INCLUDE 
INCLUDE 



N$BASE 

N$MU 

N$SC 

N$DISKIO 

N$KEYIN 

N$DISPLA 

N$CONIN 

N$CONOUT 

N$PRINT 

N$DEVICE 

N$NUMBER 

N$MULDIV 

N$RECLOC 

N$SNU 

N$BYTE 

N$EXCLUS 

N$PEEK 

N$MSG 

N$DIRECT 

N$ALLOC 

N$DATE 

N$CLOCK 

N$TIMER 

N$UTILIT 

N$MISC 

N$COMPAR 

N$ESC 

N$SEQIO 

N$OPEN 

N$CLOSE 

N$SEQDIO 

N$DIRIO 

N$IXIO 

N$LOADER 

N$ERROR 

N$NEWSYS 



Start of user area 
INCLUDE N$IPL 
LINKREF 



Low memory assignments 

Multi user definitions 

System Call dispatch 

Disk I/O interface 

Console input line 

DISPLAY, SYSDISP 

CONIN, SYSIN, CONST 

CONOUT, SYSOUT 

PRTOUT, PRINT 

DEVINIT , DEVIN , DEVST , DEVOUT , DEVUNINI , PUTDEV 

NUMBER, HEXI,HEXO, DEC I, DECO 

16 Bit MULTIPLY/DIVIDE 

Sector/File Locks 

Select-Next-User, Activate 

GETBYTE, PUTBYTE 

Lock maintence 

Peek at conout 

MSG Sender 

Volume directory management 

Volume space management 

Date & Time conversion 

TOD, MSEC, DELAY 

TEB Maintanence 

Set & Point to various areas 

Internal subroutines 

COMPARE /DISPATCH 

CONSOLE ESCAPE 

Non Disk Sequential I/O 

OPEN 

CLOSE 

Seq Disk I/O 

Direct I/O 

Indexed file I/O 

QUIT , FETCH , LOAD , PGMINIT , EXCMD 

ERRDISP,ERRQUIT 

NEWSYS 
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INCLUDE N$MUSIZE 
INCLUDE VG 
INCLUDE VGDISK 
INCLUDE VGBANK 
INCLUDE N$MUIM1 
INCLUDE VGINIT 
DEFINE RST10=RET 
DEFINE RST18=RET 
DEFINE RST20=RET 
DEFINE RST28=DEBUG 
DEFINE RST30=RET 
DEFINE RST38=RET 
DEFINE NMI=RET 
DEFINE DISKO=VGDISK 
DEFINE DISK1=VGDISK 
DEFINE DISK2=VGDISK 
DEFINE DISK3=VGDISK 
IGNORE DISK4,DISK5,DISK6 
SET NUCLEUS+3=55 
SET NUCLEUS+0EH=07BH 
SET NUCLEUS+3EH=255 
SET NUCLEUS+46H=250 
SET CLKSW=085H 
SET LUB+0=0 
SET LUB+8=16 
SET LUB+9=16 
SET UCB0+23=250,30,10 
SET UCB1+23=250,30,10 
SET UCB2+23=250,30,10 
SET UCB3+23=250,30,10 
SET UCB16+2=79 
SET UCB16+3=23 
SET UCB 16+4=6 
ORIGIN 
END 



Size all banks 
Interupts, clocks 
Disk driver 
Bank select 
INT mode 1 
IPL init routine 



,DISK7 
CLK1=55 

Set switches ERRTEXT,RTC,HIST,MODE2 on 
Multi-user switch 
4 Mhz 

RTC avail, RST5=BP 
Disk = DEVI 
CONIN=SYSTEM.DEV17 
CONOUT=SYSTEM.DEV17 
Disk STP, SET 



Line length 
Page length 
Class = 6 (Hazeltine) 
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A. 3 Example Three: Multiple PABs 



This example shows a simple program example that uses two PABs. This program is 
incomplete in that it only checks to see if the operator has requested a help 
message display. When the operator has not requested a help message the program 
exits. At this point is where the normal program logic would be coded, possibly 
using additional PABs or the same ones. 



>EDIT EX3C0DE ASSEMBLE 



NEW FILE 








EDIT 








* INPUT 










TITLE 


'Example 3 - 


multiple PABs' 


EX3C0DE: 


REL 








ENTRY 


EX3C0DE 






EXTRN 


HELP,HELPMSG 


,PROG 


EX3C0DE: 










PUSH 


BC 


; Save drive code 




PUSH 


DE 


; Save sector 




PUSH 


HL 


; Save parameter pointer 




LD 


B,9 


; Length 




LD 


DE,HELP 


; Point to HELP lit 


.TSTHELP: 










LD 


A, (DE) 


; Get byte 




CP 


(HL) 


; Compare with token 




JR 


NZ,. NOHELP 


; Branch if not equal 




INC 


DE 


; Else bump pointers 




INC 


HL 






DJNZ 


.TSTHELP 


; Loop 

; Is HELP request - display 




POP 


HL 


; Restore regs 




POP 


DE 






POP 


BC 






LD 


DE,HELPMSG 


; Point to help message 


.PAGE: 










LD 


B,9 


; Point to CONOUT 




SC 


59 


; Get lines /page 




LD 


B,C 


; Move to B reg 


.LINE: 










LD 


A, (DE) 


; Get character 




OR 


A 


; Test if end 




RET 


Z 


; Return to OASIS if is 




SC 


2 


; Else display 




DJNZ 


.LINE 


; Loop 




SC 


49 


; Wait at bottom of page 




JR 


.PAGE 


; Display next page 


.NOHELP: 










POP 


HL 


; Restore regs 




POP 


DE 






POP 


BC 






JP 


PROG 






END 


EX3C0DE 




*FILE 








U EX3C0DE. 


ASSEMBLE 


:A" filed 
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>EDIT EX3HELP ASSEMBLE: A 

NEW FILE 

EDIT 

*INPUT 

TITLE 'Example 3 - Help Message Data' 
EX3HELP: REL 

ENTRY HELP,HELPMSG 

HELP: DC 'HELP ',13 

HELPMSG: DC 'Function: To illustrate an example', 13 

DC ' of a multi-PAB program', 13 

DC ' linkage', 13 

DC 13 

DC 'Syntax: EX3C0DE [ (options [)]]', 13 

DC 13 

DC 'Where options are: ',13 

DC ' PRINTERn output to printer # n',13 

DC ' TYPE output to the console', 13 

DC ' NOTYPE suppress output', 13 

DC 

END 
*FILE 
"EX3HELP. ASSEMBLE: A" filed 

>EDIT EX3PR0G ASSEMBLE A 

NEW FILE 

EDIT 

*INPUT 

TITLE 'Example 3 - Program' 

ENTRY PROG 
EX3C0DE: REL 

PROG: 

XOR A ; Clear return code 

SC ; Exit 

END 
*FILE 
"EX3PR0G. ASSEMBLE: A" filed 

>MACR0 EX3C0DE 

Pass one 

Pass two 

No assembly errors 

>MACR0 EX3HELP 

Pass one 

Pass two 

No assembly errors 

>MACR0 EX3PR0G 

Pass one 
Pass two 
No assembly errors 
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>LINK 

#INC EX3CODE,EX3PROG,EX3HELP 

//NAME EX3:S 

#END 

LINK version 5.4B 

Memory map for EX3 . COMMAND : A 

PAB-name Low High Length Type 

EX3C0DE 0000 002B 002C REL 



04/30/80 12:08 Page 1 



Entry 



Addr 



EX3HELP 



00 2F 01 IB 00F0 REL 



EX3C0DE 


0000 


PROG 


002B 


HELP 


002C 


HELPMSG 


0038 



Entry Address: 0000 

Total Length: 01 IF (287 decimal) 
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LINK ERRORS & MESSAGES 

** File " xxxxxxxx . OBJECT" not found 

This message is displayed following an INCLUDE command of a file that cannot be 
found on any of the attached disk drives. 

** Including 

This message is displayed when the Linkage Editor is performing automatic 
includes following an END command. 

** Invalid character In expression 

This message is displayed when an invalid expression is detected. Expression 
may only contain valid symbols (one to eight characters in length, must start 
with a letter and contain only letters, digits, dollar signs, and periods) 
numeric constants (must start with a digit and contain only digits, the letters 
A through F, and may be terminated with the letter H) and the arithmetic 
operators: + - * /. 

** Invalid command 

** Not Implemented 

** Relocation error 

Indicates that an expression containing relocatable symbols is in error. 

Usually the error is one of the following: a difference between two relocatable 

symbols of different PABs; the sum of two relocatable symbols; the product of 

two relocatable symbols; the quotient of two relocatable symbols; the product or 
quotient of a relocatable symbol and an absolute symbol. 

** Too many segments 

Up to 128 segments or object modules may be included in one linkage. 

** Undefined symbol 

An expression using symbols or the DEFINE, IGNORE, or REPLACE command reference 
an undefined symbol (a symbol not specified by an entry or external definition 
record) . 
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Reader 's Comments 

Name Date / / 

Organization 

Street 

City State Zip 

Name of manual: 

Did you find errors in this manual? If so, specify with page number. 



Did you find this manual understandable, usable, and well-organized? 
Please make suggestions for improvement. 



Is there sufficient documentation on associated system programs required for use of 
the software described in this manual? If not, what material is missing and where 
should it be placed? 



Indicate the type of user /reader that you most nearly represent: 

Assembly language programmer 

Higher-level language programmer (BASIC, FORTRAN, etc) 

Occasional programmer (experienced) 

User with little programming experience 

Student programmer 

Non-programmer interested in computer concepts and capabilities 

Data entry operator 

Mail to: OASIS Documentation 

Phase One Systems, Inc. 
7700 Edgewater Drive #830 
Oakland, CA 94621 



